# basic_ops.py - 基本数学运算模块

# 控制 import * 导入的内容
__all__ = ['add', 'subtract', 'multiply', 'divide']

def add(a, b):
    """加法运算
    Args:
        a (int/float): 第一个数
        b (int/float): 第二个数
    Returns:
        int/float: 两数之和
    """
    return a + b

def subtract(a, b):
    """减法运算
    Args:
        a (int/float): 被减数
        b (int/float): 减数
    Returns:
        int/float: 两数之差
    """
    return a - b

def multiply(a, b):
    """乘法运算
    Args:
        a (int/float): 第一个数
        b (int/float): 第二个数
    Returns:
        int/float: 两数之积
    """
    return a * b

def divide(a, b):
    """除法运算
    Args:
        a (int/float): 被除数
        b (int/float): 除数
    Returns:
        float: 两数之商
    Raises:
        ZeroDivisionError: 当除数为0时抛出异常
    """
    if b == 0:
        raise ZeroDivisionError("除数不能为零")
    return a / b

def _private_helper():
    """私有辅助函数，仅供模块内部使用"""
    return "这是模块内部使用的函数"

# 模块测试代码
if __name__ == "__main__":
    print("基本数学运算模块测试:")
    print(f"加法: 3 + 5 = {add(3, 5)}")
    print(f"减法: 10 - 3 = {subtract(10, 3)}")
    print(f"乘法: 4 * 6 = {multiply(4, 6)}")
    print(f"除法: 15 / 3 = {divide(15, 3)}")